Inside Macintosh: Programming With JManager /

Chapter 2 - JManager Reference / JManager Functions

Applet Control Functions /

JMNewAppletLocator

Locates an applet asynchronously by fetching an HTML document from a specified URL.

OSStatus JMNewAppletLocator (
                     JMAppletLocatorRef* locatorRef, 
                     JMSessionRef session, 
                     const JMAppletLocatorCallbacks* callbacks, 
                     const JMTextRef url, 
                     const JMTextRef htmlText, 
                     JMClientData data);

locatorRef

A pointer to the locator. On return, this parameter is the new applet locator.

session

The session in which you want to instantiate the applet.

callbacks

A pointer to an applet locator callbacks structure. For more information, see "Applet Locator Callback Structure".

url

A text object containing the text of the URL.

htmlText

Optional text (stored as a text object) containing one or more applet tags.

data

Optional client-specific data.

function result

A result code; see "JManager Result Codes".

DISCUSSION

If you have already retrieved the HTML document, you can pass it to JMNewAppletLocator in the htmlText argument. Otherwise, JMNewAppletLocator starts a separate thread to retrieve the document. The client application must call JIdle to allow the new thread time to retrieve the document. The callback that executes upon fetching the HTML document can occur either while this function is executing or some time after it has returned.

SEE ALSO

"Finding Applets".

The JMNewAppletLocatorFromInfo function.

The JMDisposeAppletLocator function.